home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / p_man / cat3c / cap_acquire.z / cap_acquire
Encoding:
Text File  |  2002-10-03  |  2.6 KB  |  67 lines
  1.  
  2.  
  3.  
  4. CCCCAAAAPPPP____AAAACCCCQQQQUUUUIIIIRRRREEEE((((3333CCCC))))                                                CCCCAAAAPPPP____AAAACCCCQQQQUUUUIIIIRRRREEEE((((3333CCCC))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      cap_acquire, cap_surrender  - make permitted set capabilities effective
  10.      or remove effective capabilities
  11.  
  12. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  13.      ####iiiinnnncccclllluuuuddddeeee <<<<ssssyyyyssss////ccccaaaappppaaaabbbbiiiilllliiiittttyyyy....hhhh>>>>
  14.  
  15.      ccccaaaapppp____tttt ccccaaaapppp____aaaaccccqqqquuuuiiiirrrreeee(((( iiiinnnntttt nnnnccccaaaapppp,,,, ccccoooonnnnsssstttt ccccaaaapppp____vvvvaaaalllluuuueeee____tttt ****ccccaaaappppssss))));;;;
  16.      vvvvooooiiiidddd ccccaaaapppp____ssssuuuurrrrrrrreeeennnnddddeeeerrrr(((( ccccaaaapppp____tttt ccccaaaapppp))));;;;
  17.  
  18. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  19.      _c_a_p__a_c_q_u_i_r_e activates the capabilities from the permitted set of the
  20.      process by making each of them active in the effective set for the
  21.      process.
  22.  
  23.      _c_a_p__s_u_r_r_e_n_d_e_r sets the effective set to the capabilities specified in the
  24.      _c_a_p argument, and deallocates this structure.
  25.  
  26. RRRREEEETTTTUUUURRRRNNNN VVVVAAAALLLLUUUUEEEESSSS
  27.      _c_a_p__a_c_q_u_i_r_e returns the previous effective set, or NULL if there were
  28.      errors. NULL may also be returned if the process has no current
  29.      capability set.  This return value has been allocated by the library, and
  30.      should be freed when no longer needed, most commonly by calling
  31.      _c_a_p__s_u_r_r_e_n_d_e_r to revert the effective set to its prior value.
  32.      _c_a_p__f_r_e_e(3c) may also be called directly to deallocate the structure.
  33.  
  34.      _c_a_p__s_u_r_r_e_n_d_e_r has no return value.
  35.  
  36. EEEERRRRRRRROOOORRRRSSSS
  37.      _c_a_p__a_c_q_u_i_r_e:
  38.  
  39.      EINVAL          _c_a_p_s is null.
  40.  
  41.      ENOSYS          capabilities are not enabled.
  42.  
  43. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  44.      cap_free(3c), capabilities(4).
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.